home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / news / inn1.000 / inn1.4sec-linux-src.tar / inn / README < prev    next >
Text File  |  1993-12-22  |  5KB  |  104 lines
  1. Wed Dec 22 09:46:22 EST 1993
  2.  
  3. This is INN1.4-sec.  It is INN1.4 with a security patch installed.
  4. Without this patch, any control messages that get mailed can, on many
  5. systems, end up invoking any command as the news admin.  This is
  6. more properly a bug in mail (the UCB Mail program), but INN should not
  7. let itself be vunerable to it.
  8.  
  9. This patch (except for the include/patchlevel.h date change and this
  10. note in the README) will be part of INN1.5.
  11.     /r$
  12.  
  13. $Revision: 1.28 $
  14.  
  15. InterNetNews -- the Internet meets Netnews
  16. ------------------------------------------
  17. "Remember to tell your kids about the days when USENET was store and
  18.  forward."  -- Jim Thompson, as part of a message that said he was getting
  19.  under 200ms propagation, disk to disk.
  20.  
  21. InterNetNews is a complete Usenet system.  The cornerstone of the package
  22. is innd, an NNTP server that multiplexes all I/O.  Think of it as an nntpd
  23. merged with the B News inews, or as a C News relaynews that reads multiple
  24. NNTP streams.  Newsreading is handled by a separate server, nnrpd, that is
  25. spawned for each client.  Both innd and nnrpd have some slight variances
  26. from the NNTP protocol; see the manpages.
  27.  
  28. The distribution is a compressed tar file.  Create a directory, cd into it,
  29. and unpack the tar file in that directory.  For example:
  30.     ; mkdir inn
  31.     ; cd inn
  32.     ; ftp ftp.uu.net
  33.     ftp> user anonymous <you@your.host.name>
  34.     ftp> type image
  35.     ftp> get news/nntp/inn/inn.tar.Z inn.tar.Z
  36.     ftp> quit
  37.     ; uncompress <inn.tar.Z | tar vxf -
  38.     ; rm inn.tar.Z
  39.  
  40. The installation instructions are in Install.ms.  This is an nroff/troff
  41. document that uses the -ms macro package, and is about 30 typeset pages.
  42. The distribution has this file split into two pieces; you can join them
  43. by typing either of the following commmands:
  44.     ; make Install.ms
  45.     ; cat Install.ms.? >Install.ms
  46. You should probably print out a copy of config/config.dist when you print
  47. out the installation manual.
  48.  
  49. Please read the COPYRIGHT.  This package has NO WARRANTY; use at your
  50. own risk.
  51.  
  52. When updating from a previous release, you will usually want to do "make
  53. update" from the top-level directory; this will only install the programs.
  54. To update your scripts and config files, cd into the "site" directory and
  55. do "make clean" -- this will remove any files that are unchanged from
  56. the official release.  Then do "make diff >diff"; this will show you what
  57. changes you will have to merge in.  Now merge in your changes (from
  58. where the files are, ie. /usr/lib/news...) into the files in
  59. $INN/site.  (You may find that due to the bug fixes and new features in
  60. this release, you may not need to change any of the scripts, just the
  61. configuration files).  Finally, doing "make install" will install
  62. everything.
  63.  
  64. If you have a previous release you will probably also want to update the
  65. pathnames, etc., in the new config file from your old config.  Here is one
  66. way to do that:
  67.     % cd config
  68.     % make subst
  69.     % cp config.dist config.data
  70.     % ./subst -f {OLDFILE} config.data
  71. where "{OLDFILE}" names your old config.data file.
  72.  
  73. Configuration is done using subst.   Subst is in config/subst.sh and
  74. doc/subst.1.  The history file is written using DBZ.  The DBZ sources and
  75. manual page are in the dbz directory.  Unlike subst, DBZ is kept
  76. separately, to make it easier to track the C News release.  The subst
  77. script and DBZ data utilities are currently at the "Performance Release"
  78. patch date.  Thanks to Henry Spencer and Geoff Collyer for permission to
  79. use and redistribute subst, and to Jon Zeef for permission to use DBZ as
  80. modified by Henry.
  81.  
  82. This version includes support for Geoff Collyer's news overview package,
  83. known as nov.  Nov replaces the external databases used by nn, trn, etc.,
  84. with a common text database.  INN support includes programs to build and
  85. maintain the overview database, and an XOVER command added to nnrpd (the
  86. news-reading daemon) that is becoming a common extension to fetch the
  87. overview data from an NNTP connection.  Nnrpd uses the overview database
  88. internally, if it exists, making certain commands (e.g., XHDR) much
  89. faster.  The nov package includes a newsreader library that you will need,
  90. and some utilities that you will not; it is available on world.std.com in
  91. the file src/news/nov.dist.tar.Z.  Prototypes of modified newsreaders are
  92. in the in src/news/READER.dist.tar.Z -- most maintainers will be providing
  93. official support very soon.  To make it explicit:  if you already have a
  94. newsreader that can use the overview database, either via my NNTP xover
  95. command, or by reading directly from NFS, then INN has all you need.
  96.  
  97. I hope you find INN useful.  If you like it, send me a postcard.
  98.     Rich $alz
  99.     Open Software Foundation
  100.     11 Cambridge Center
  101.     Cambridge, MA  02142
  102.     INN mail:    <rsalz@uunet.uu.net>
  103.     Other mail:    <rsalz@osf.org>
  104.